home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmStringGetNextSegment.z / XmStringGetNextSegment
Encoding:
Text File  |  2002-10-03  |  4.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttSSSSeeeeggggmmmmeeeennnntttt((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttSSSSeeeeggggmmmmeeeennnntttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttSSSSeeeeggggmmmmeeeennnntttt - A compound string function that
  10.           fetches the bytes in the next segment of a compound string
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           BBBBoooooooolllleeeeaaaannnn XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttSSSSeeeeggggmmmmeeeennnntttt(
  15.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnntttteeeexxxxtttt ccccoooonnnntttteeeexxxxtttt,
  16.           cccchhhhaaaarrrr ********tttteeeexxxxtttt,
  17.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaagggg ****ttttaaaagggg,
  18.           XXXXmmmmSSSSttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn ****ddddiiiirrrreeeeccccttttiiiioooonnnn,
  19.           BBBBoooooooolllleeeeaaaannnn ****sssseeeeppppaaaarrrraaaattttoooorrrr);
  20.  
  21.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  22.           This page documents Motif 2.1.
  23.  
  24.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.           This routine is obsolete and exists for compatibility with
  26.           previous releases. To read the contents of a compound
  27.           string, read each component of the string with
  28.           XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttTTTTrrrriiiipppplllleeee. This XXXXmmmmSSSSttttrrrriiiinnnngggg function returns the
  29.           type, length, and value of the next component in the
  30.           compound string.  XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttSSSSeeeeggggmmmmeeeennnnttttfetches the bytes in
  31.           the next segment; repeated calls fetch sequential segments.
  32.           The _t_e_x_t, _t_a_g, and _d_i_r_e_c_t_i_o_n of the fetched segment are
  33.           returned each time. A Boolean status is returned to indicate
  34.           whether a valid segment was successfully parsed.
  35.  
  36.           If the function returns True, then the function allocates
  37.           space to hold the returned _t_e_x_t and _t_a_g. The application is
  38.           responsible for managing the allocated space. The
  39.           application can recover the allocated space by calling
  40.           XXXXttttFFFFrrrreeeeeeee.
  41.  
  42.           _c_o_n_t_e_x_t   Specifies the string context structure which was
  43.                     allocated by the XXXXmmmmSSSSttttrrrriiiinnnnggggIIIInnnniiiittttCCCCoooonnnntttteeeexxxxtttt function
  44.  
  45.           _t_e_x_t      Specifies a pointer to a NULL-terminated string
  46.  
  47.           _t_a_g       Specifies a pointer to the font list element tag
  48.                     associated with the text
  49.  
  50.           _d_i_r_e_c_t_i_o_n Specifies a pointer to the direction of the text
  51.  
  52.           _s_e_p_a_r_a_t_o_r Specifies whether the next component of the
  53.                     compound string is a separator
  54.  
  55.      RRRREEEETTTTUUUURRRRNNNN
  56.           Returns True if a valid segment is found.
  57.  
  58.      RRRREEEELLLLAAAATTTTEEEEDDDD
  59.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee(3) and XXXXmmmmSSSSttttrrrriiiinnnnggggIIIInnnniiiittttCCCCoooonnnntttteeeexxxxtttt(3).
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.